home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 5 / Amiga Plus Sonderheft 1996 #5.iso / programme / imagedesk304 / imagedesk / instdata.lha / instdata / MIPFIC.doc < prev    next >
Text File  |  1996-01-15  |  7KB  |  212 lines
  1.  
  2.                               MIPFIC 1.0
  3.                               ==========
  4.  
  5.           MIPFIC is Copyright © 1995-1996 Reinhard Haslbeck.
  6.                          All rights reserved.
  7.  
  8.  
  9. Disclaimer
  10. ----------
  11.  
  12. With this document I make no  warranties  or  representations,  either
  13. expressed  or  implied,  with respect to the program described herein.
  14. The program and the information presented herein is being supplied  on
  15. an  `as  is'  basis and is expressly subject to change without notice.
  16. The entire risk as to the use  of  the  program  and  the  information
  17. presented  is  assumed  by  the user. In no event will I be liable for
  18. direct, indirect, incidental, or consequential damages resulting  from
  19. any  claim  arising  out  of the use of the program or the information
  20. presented herein, even if I have been advised of the possibilities  of
  21. such damages.
  22.  
  23.  
  24. Introduction to MIPFIC
  25. ----------------------
  26.  
  27. Since ImageDesk catalogs are just usable on Amigas, MIPFIC offers  the
  28. possibility  to  present  graphics collections in a system independend
  29. manner.
  30.  
  31. MIPFIC stands for `Make Index Pictures From ImageDesk  Catalogs`.  The
  32. program name says exactly what it does. It generates IFF pictures from
  33. catalogs made with ImageDesk. MIPFIC allows various layout styles such
  34. as  different border and text styles, custom spacing etc. To check how
  35. the current layout looks like, it has a built in preview function.
  36.  
  37.  
  38. System Requirements
  39. -------------------
  40.  
  41. MIPFIC should run on every 68K CPU, it was compiled and optimized  for
  42. the plain 68000.
  43.  
  44. MIPFIC currently requires an Amiga running Workbench/Kickstart 3.0  or
  45. higher,  it also needs the following libraries (they should be in your
  46. LIBS: directory): `asl.library`, `diskfont.library` and  `iff.library'
  47. V23.
  48.  
  49. The resulting index pictures will have 256 colors. To enable a preview
  50. of the pictures, MIPFIC requires a graphics device which allows system
  51. friendly 8bit screens.
  52.  
  53.  
  54. Starting MIPFIC
  55. ---------------
  56.  
  57. During startup MIPFIC looks for the standard prefs file. If it doesn`t
  58. find one default values will be used.
  59.  
  60. You can place MIPFIC anywhere you want, but if you change the position
  61. of  the  program,  it won`t find its default prefs file `MIPFIC.prefs`
  62. anymore.
  63.  
  64. MIPFIC can be started from the Workbench or from a Shell. You can  use
  65. different arguments to change the startup behavoir of MIPFIC.
  66.  
  67. When MIPFIC was started from  a  Shell  it  will  read  the  specified
  68. arguments  from  the  commandline  (with  ReadArgs()).IF  started from
  69. Workbench it will examine its Icon Tooltypes.
  70.  
  71. When you use MIPFIC from the Workbench, you can change  or  add  these
  72. arguments  by changing or adding the Tool Type (with the same name) in
  73. the  window  that  appears  when  you  select   the   `Information...'
  74. menu item.
  75.  
  76. Recognized Tooltypes:
  77.  
  78.              - PREFS     (uses the specified file name
  79.                           for the default prefs file)
  80.              - PUBSCREEN (opens its GUI on the specified screen)
  81.  
  82. When you use MIPFIC from a Shell you can specify the same arguments on
  83. the commandline. MIPFIC uses this template:
  84.  
  85.              P=PREFS/K,S=PUBSCREEN/K
  86.  
  87.  
  88.  
  89. Using MIPFIC
  90. ------------
  91.  
  92. This section is just a quick overview of MIPFICs Gadgets. In My opinon
  93. this program is easy enough to use to omit large texts of description.
  94.  
  95.  
  96. Framed Box `Screen`
  97. ...................
  98.  
  99. A click into the `?`-Button pops up the screen requester. The selected
  100. screen  is  used for previewing the pictures. `Width` and `Height` are
  101. also used for the dimensions of the resulting IFF pictures.
  102.  
  103.  
  104. Framed Box `Font`
  105. .................
  106.  
  107. A click into the `?`-Button pops up the font requester.  The  selected
  108. font  is  used for printing the file names below the thumbnail images.
  109. (also supports selected flags like `italic`, `bold` etc.)
  110.  
  111.  
  112. Framed Box `Colors`
  113. ...................
  114.  
  115. These four Integer Gadgets specify which color registers will be  used
  116. for  background,  bright edges, dark edges and text. To find out which
  117. colors the registers are assigned to,  use  a  painting  program  like
  118. DPaint,  load  a MIPFIC generated IFF picture into it and activate the
  119. palette tool (All resulting pictures will have this palette).
  120.  
  121.  
  122. Framed Box `Layout`
  123. ...................
  124.  
  125. The two Cycle Gadgets allow different text and border styles. With the
  126. two  Slider  Gadgets  you  can  regulate  the  horizontal and vertical
  127. spacing between the thumbnails. Simply test it!
  128.  
  129.  
  130. Framed Box `Commands`
  131. .....................
  132.  
  133. `Open Catalog`: Opens a  file  requester  which  prompts  you  for  an
  134. ImageDesk catalog.
  135.  
  136. `Preview Screen(s)`: Previews the pictures  with  the  current  layout
  137. settings.  If  this  screen  is displayed you can abort the preview by
  138. pressing the <ESC> key or continue  to  render  the  next  picture  by
  139. pressing any other key.
  140.  
  141. `Make Index Pic(s)`: First prompts for a file name  the  IFF  pictures
  142. will get (if more than one IFF picture has to be saved, the file names
  143. will get a numbered extension). The pictures are rendered hidden,  you
  144. just will see the busy mouse pointer.
  145.  
  146. `Save Settings`: Saves your current settings as the default prefs file.
  147.  
  148. `Save Settings As`: Saves your current  settings  but  prompts  for  a
  149. custom file name first.
  150.  
  151. `Load Settings`: Opens a former saved prefs file.
  152.  
  153. `About`: Tells something interesting.
  154.  
  155. `Quit`: Quits MIPFIC after a security check.
  156.  
  157.  
  158. Framed Box `Status`
  159. ...................
  160.  
  161. Here you will find some information:
  162.  
  163. Catalog loaded:          Has a catalog already been loaded?
  164. Valid Screen:            Are the screen specs valid?
  165. Thumbnails per Picture:  How many thumbnails will fit on one IFF picture?
  166. Required Pictures:       How many IFF pictures are needed for all thumbs?
  167.  
  168.  
  169. Notes
  170. -----
  171.  
  172. This program was coded in just a few days during the  X-Mas  holidays.
  173. It  hasn´t passed a beta test phase so it is likely to have some bugs.
  174. Anyway, Enforcer hits and memory leaks haven´t been detected.
  175.  
  176. MIPFIC supports  XPK  compressed  catalogs  but  doesn´t  support  XPK
  177. password  encrypted  catalogs.  If you want to load encrypted catalogs
  178. decrypt them first with `CATRepack`.
  179.  
  180. If MIPFICs GUI doesn´t look very good because of  overlapping  gadgets
  181. and  boxes,  simply resize its window and do a `Save Settings´. MIPFIC
  182. automatically will rearange the GUI and the new window  size  will  be
  183. stored in the prefs file.
  184.  
  185. Feature requests to support further image  formats  will  be  ignored.
  186. IMHO  there  are enough converting tools available to do this job. But
  187. please do me one favour and  don´t  convert  these  IFFs  into  JPEGs.
  188. MIPFIC  produces 8bit colormapped IFFs which are not very suitable for
  189. JPEG. To save disk space PNG and GIF are well suited formats.
  190.  
  191.  
  192. Thanks and Credits
  193. ------------------
  194.  
  195. MIPFIC uses
  196.  
  197.       - `gengui 1.0` from Matthias Meixner for its GUI-Layout
  198.       - `iff.library V23` from Christian Weber for saving IFF images
  199.  
  200. A big `Thank You` must go to all of you who decided  to  register  for
  201. ImageDesk. Without you MIPFIC and even ImageDesk 2.x wouldn´t exist.
  202.  
  203.  
  204. About the Author
  205. ----------------
  206.  
  207. MIPFIC was written by Reinhard Haslbeck.
  208.  
  209. If you have a good  reason  to  contact  me,  take  a  look  into  the
  210. ImageDesk docs for getting my address.
  211.  
  212.